---
title: "SQL-VP-022: Retrieve policy periods for a policy"
summary: Retrieves the ordered set of policy periods for a policy via the Oracle view-policy package.
status: draft
owner: SAIF Claims BOF team
last_reviewed: 2026-08-21
library: SAIF.Business.View.Policy
reference_type: embedded
---

# SQL-VP-022 Retrieve policy periods for a policy

The primary retrieval path for `clsPolicyPeriodCollection`, which is the sole populator of
`clsPolicyPeriod` instances via `AfterRetrieve` → `Load(...)` (`clsPolicyPeriod` has no independent
retrieval of its own).

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-VP-022 |
| **Operation type** | Read |
| **Execution method** | Stored procedure |
| **Database** | Oracle |
| **Schema** | `[unqualified]**` |
| **Command type** | StoredProcedure |
| **Business object** | `clsPolicyPeriodCollection` |
| **Criteria property** | `RetrieveSQL` |
| **Lifecycle method** | `BeforeRetrieve` / `AfterRetrieve` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `apolicynum` | Input | Decimal | N/A | Policy number to retrieve periods for. |
| `aTopNPolPer` | Input | Numeric | N/A | Top-N period limiter. |
| `recordset` | Output (Cursor) | REF CURSOR | N/A | Result set containing policy period rows. |

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| *(not directly visible — encapsulated in procedure body)* | SELECT | N/A |

## Sample SQL

```sql
BEGIN
  pk72846_view_policy.getPolicyPeriods(
    apolicynum   => :apolicynum,
    aTopNPolPer  => :aTopNPolPer,
    recordset    => :recordset
  );
END;
```

*Call signature reconstructed from `DataRequest.SQLStatement`/`AddParm`/`AddCursorParm` calls; the
procedure body resides in the Oracle database and was not retrieved this run.*

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts. Statements marked with `**` could not be confirmed; treat
> as unknown until verified.

## Sources
- `SAIF.Business.View.Policy\clsPolicyPeriodCollection.vb`